package org.jsola.hr.service;

import org.jsola.core.Page;
import org.jsola.core.service.IService;
import org.jsola.hr.dao.IAttendPunchStaffDAO;
import org.jsola.hr.dto.AttendPunchStaffAddDTO;
import org.jsola.hr.dto.AttendPunchStaffUpdateDTO;
import org.jsola.hr.entity.AttendPunchStaffDO;
import org.jsola.hr.query.AttendPunchStaffQuery;
import org.jsola.hr.vo.AttendPunchStaffListVO;
import org.jsola.hr.vo.AttendPunchStaffVO;
import org.jsola.user.core.TokenUser;

import java.util.List;


/**
 * @author zhr
 */
public interface IAttendPunchStaffService extends IService<IAttendPunchStaffDAO, AttendPunchStaffDO> {

    /**
     * 新增考勤打卡参与人员
     * @param attendPunchStaffAddDTO 新增考勤打卡参与人员DTO
     * @param tokenUser 当前用户
     * @return 考勤打卡参与人员详情信息
     */
    AttendPunchStaffVO save(AttendPunchStaffAddDTO attendPunchStaffAddDTO, TokenUser tokenUser);

    /**
     * 修改考勤打卡参与人员
     * @param attendPunchStaffUpdateDTO 修改考勤打卡参与人员DTO
     * @param tokenUser 当前用户
     * @return 更新数量
     */
    int update(AttendPunchStaffUpdateDTO attendPunchStaffUpdateDTO, TokenUser tokenUser);


    /**
     * 批量删除考勤打卡参与人员，物理删除，更新is_valid字段，从回收站删除
     * @param tokenUser 当前用户
     * @param attendPunchStaffIds 考勤打卡参与人员id
     * @return 删除数量
     */
    int deleteByIds(TokenUser tokenUser, String...attendPunchStaffIds);

    /**
     * 根据考勤打卡参与人员id查找
     * @param attendPunchStaffId 考勤打卡参与人员id
     * @param siteId 所属站点id
     * @return 考勤打卡参与人员详情信息
     */
    AttendPunchStaffVO selectById(String attendPunchStaffId, String siteId);

    /**
     * 查询考勤打卡参与人员
     * @param attendPunchStaffQuery 查询条件
     * @param siteId 所属站点id
     * @return 考勤打卡参与人员列表信息
     */
    List<AttendPunchStaffListVO> select(AttendPunchStaffQuery attendPunchStaffQuery, String siteId);

    /**
    * 查询考勤打卡参与人员记录数
    * @param attendPunchStaffQuery 查询条件
    * @param siteId 所属站点id
    * @return 考勤打卡参与人员记录数
    */
    int selectCount(AttendPunchStaffQuery attendPunchStaffQuery, String siteId);

    /**
     * 分页查询考勤打卡参与人员
     * @param attendPunchStaffQuery 查询条件
     * @param siteId 所属站点id
     * @return 考勤打卡参与人员列表信息
     */
    Page<AttendPunchStaffListVO> selectPage(AttendPunchStaffQuery attendPunchStaffQuery, String siteId);


    /**
     * 根据考勤打卡参与人员id查找
     * @param attendPunchStaffId 考勤打卡参与人员id
     * @param siteId 所属站点id
     * @return 考勤打卡参与人员
     */
    AttendPunchStaffDO selectDOById(String attendPunchStaffId, String siteId);

    /**
     * 查询考勤打卡参与人员
     * @param attendPunchStaffQuery 查询条件
     * @param siteId 所属站点id
     * @return 考勤打卡参与人员列表
     */
    List<AttendPunchStaffDO> selectDO(AttendPunchStaffQuery attendPunchStaffQuery, String siteId);

    /**
     * 根据考勤方案ID物理删除
     *
     * @param attendPlanId 考勤方案ID
     * @param siteId 所属站点id
     * @return 更新数量
     */
    int deleteByAttendPlanId(String attendPlanId, String siteId);

    /**
     * 根据考勤规则ID逻辑删除
     *
     * @param attendPlanId 考勤规则ID
     * @param tokenUser 当前用户
     * @return 删除结果
     */
    int logicDelByAttendPlanId(String attendPlanId, TokenUser tokenUser);
}


